home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / impRGBtoW.z / impRGBtoW
Text File  |  1998-10-30  |  22KB  |  460 lines
  1.  
  2.  
  3.  
  4. iiiimmmmppppRRRRGGGGBBBBttttooooWWWW((((3333))))                     IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                      iiiimmmmppppRRRRGGGGBBBBttttooooWWWW((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      impRGBtoW, impWtoRGB, impRGBtoK, impKtoRGB, impRGBtoCMY, impCMYtoRGB,
  10.      impRGBtoYIQ, impYIQtoRGB, impRGBtoYUV, impYUVtoRGB, impRGBtoYCbCr,
  11.      impYCbCrtoRGB, impRGBtoCMYK, impRGBtoDevCMYK, impCMYKtoRGB, impRGBtoHSV,
  12.      impHSVtoRGB, impRGBtoHLS, impHLStoRGB - color space conversion
  13.  
  14. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  15.      ####iiiinnnncccclllluuuuddddeeee <<<<iiiimmmmpppp....hhhh>>>>
  16.  
  17.      W Conversions:
  18.  
  19.      vvvvooooiiiidddd iiiimmmmppppRRRRGGGGBBBBttttooooWWWW((((sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,,
  20.                     sssshhhhoooorrrrtttt ****wwwwbbbbuuuuffff,,,, iiiinnnntttt nnnn))));;;;
  21.  
  22.      vvvvooooiiiidddd iiiimmmmppppWWWWttttooooRRRRGGGGBBBB((((sssshhhhoooorrrrtttt ****wwwwbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuuffff,,,,
  23.                      sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,, iiiinnnntttt nnnn))));;;;
  24.  
  25.      K Conversions:
  26.  
  27.      vvvvooooiiiidddd iiiimmmmppppRRRRGGGGBBBBttttooooKKKK((((sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,,
  28.                     sssshhhhoooorrrrtttt ****kkkkbbbbuuuuffff,,,, sssshhhhoooorrrrtttt uuuunnnniiiittttyyyy,,,, iiiinnnntttt nnnn))));;;;
  29.  
  30.      vvvvooooiiiidddd iiiimmmmppppKKKKttttooooRRRRGGGGBBBB((((sssshhhhoooorrrrtttt ****kkkkbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuuffff,,,,
  31.                      sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,, sssshhhhoooorrrrtttt uuuunnnniiiittttyyyy,,,, iiiinnnntttt nnnn))));;;;
  32.  
  33.      CMY Conversions:
  34.  
  35.      vvvvooooiiiidddd iiiimmmmppppRRRRGGGGBBBBttttooooCCCCMMMMYYYY((((sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,,
  36.                       sssshhhhoooorrrrtttt ****ccccbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****mmmmbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****yyyybbbbuuuuffff,,,,
  37.                       sssshhhhoooorrrrtttt uuuunnnniiiittttyyyy,,,, iiiinnnntttt nnnn))));;;;
  38.  
  39.      vvvvooooiiiidddd iiiimmmmppppCCCCMMMMYYYYttttooooRRRRGGGGBBBB((((sssshhhhoooorrrrtttt ****ccccbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****mmmmbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****yyyybbbbuuuuffff,,,,
  40.                       sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,,
  41.                       sssshhhhoooorrrrtttt uuuunnnniiiittttyyyy,,,, iiiinnnntttt nnnn))));;;;
  42.  
  43.      YIQ Conversions:
  44.  
  45.      vvvvooooiiiidddd iiiimmmmppppRRRRGGGGBBBBttttooooYYYYIIIIQQQQ((((sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,,
  46.                       sssshhhhoooorrrrtttt ****yyyybbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****iiiibbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****qqqqbbbbuuuuffff,,,,
  47.                       iiiinnnntttt nnnn))));;;;
  48.  
  49.      vvvvooooiiiidddd iiiimmmmppppYYYYIIIIQQQQttttooooRRRRGGGGBBBB((((sssshhhhoooorrrrtttt ****yyyybbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****iiiibbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****qqqqbbbbuuuuffff,,,,
  50.                       sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,,
  51.                       iiiinnnntttt nnnn))));;;;
  52.  
  53.      YUV Conversions:
  54.  
  55.      vvvvooooiiiidddd iiiimmmmppppRRRRGGGGBBBBttttooooYYYYUUUUVVVV((((sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,,
  56.                       sssshhhhoooorrrrtttt ****yyyybbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****uuuubbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****vvvvbbbbuuuuffff,,,,
  57.                       iiiinnnntttt nnnn))));;;;
  58.  
  59.      vvvvooooiiiidddd iiiimmmmppppYYYYUUUUVVVVttttooooRRRRGGGGBBBB((((sssshhhhoooorrrrtttt ****yyyybbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****uuuubbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****vvvvbbbbuuuuffff,,,,
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiimmmmppppRRRRGGGGBBBBttttooooWWWW((((3333))))                     IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                      iiiimmmmppppRRRRGGGGBBBBttttooooWWWW((((3333))))
  71.  
  72.  
  73.  
  74.                      sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,,
  75.                       iiiinnnntttt nnnn))));;;;
  76.  
  77.      YCbCr Conversions:
  78.  
  79.      vvvvooooiiiidddd iiiimmmmppppRRRRGGGGBBBBttttooooYYYYCCCCbbbbCCCCrrrr((((sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,,
  80.                         sssshhhhoooorrrrtttt ****yyyybbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ccccbbbbbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ccccrrrrbbbbuuuuffff,,,,
  81.                         iiiinnnntttt nnnn))));;;;
  82.  
  83.      vvvvooooiiiidddd iiiimmmmppppYYYYCCCCbbbbCCCCrrrrttttooooRRRRGGGGBBBB((((sssshhhhoooorrrrtttt ****yyyybbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ccccbbbbbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ccccrrrrbbbbuuuuffff,,,,
  84.                         sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,,
  85.                         iiiinnnntttt nnnn))));;;;
  86.  
  87.      CMYK Conversions:
  88.  
  89.      vvvvooooiiiidddd iiiimmmmppppRRRRGGGGBBBBttttooooCCCCMMMMYYYYKKKK((((sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,,
  90.                        sssshhhhoooorrrrtttt ****ccccbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****mmmmbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****yyyybbbbuuuugggg,,,,
  91.                        sssshhhhoooorrrrtttt ****kkkkbbbbuuuuffff,,,, sssshhhhoooorrrrtttt uuuunnnniiiittttyyyy,,,, iiiinnnntttt nnnn))));;;;
  92.  
  93.      vvvvooooiiiidddd iiiimmmmppppRRRRGGGGBBBBttttooooDDDDeeeevvvvCCCCMMMMYYYYKKKK((((sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,,
  94.                           sssshhhhoooorrrrtttt ****ccccbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****mmmmbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****yyyybbbbuuuugggg,,,,
  95.                           sssshhhhoooorrrrtttt ****kkkkbbbbuuuuffff,,,, IIIIMMMMPPPPUUUUCCCCRRRRFFFFuuuunnnncccc uuuuccccrrrr,,,, IIIIMMMMPPPPBBBBGGGGFFFFuuuunnnncccc bbbbgggg,,,,
  96.                           sssshhhhoooorrrrtttt uuuunnnniiiittttyyyy,,,, iiiinnnntttt nnnn))));;;;
  97.  
  98.           sssshhhhoooorrrrtttt ((((****IIIIMMMMPPPPBBBBGGGGFFFFuuuunnnncccc))))((((sssshhhhoooorrrrtttt kkkk))));;;;
  99.           sssshhhhoooorrrrtttt ((((****IIIIMMMMPPPPUUUUCCCCRRRRFFFFuuuunnnncccc))))((((sssshhhhoooorrrrtttt kkkk))));;;;
  100.  
  101.      vvvvooooiiiidddd iiiimmmmppppCCCCMMMMYYYYKKKKttttooooRRRRGGGGBBBB((((sssshhhhoooorrrrtttt ****ccccbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****mmmmbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****yyyybbbbuuuuffff,,,,
  102.                        sssshhhhoooorrrrtttt ****kkkkbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuugggg,,,,
  103.                        sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,, sssshhhhoooorrrrtttt uuuunnnniiiittttyyyy,,,, iiiinnnntttt nnnn))));;;;
  104.  
  105.      HSV Conversions:
  106.  
  107.      vvvvooooiiiidddd iiiimmmmppppRRRRGGGGBBBBttttooooHHHHSSSSVVVV((((sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,,
  108.                       ffffllllooooaaaatttt ****hhhhbbbbuuuuffff,,,, ffffllllooooaaaatttt ****ssssbbbbuuuuffff,,,, ffffllllooooaaaatttt ****vvvvbbbbuuuuffff,,,,
  109.                       iiiinnnntttt nnnn))));;;;
  110.  
  111.      vvvvooooiiiidddd iiiimmmmppppHHHHSSSSVVVVttttooooRRRRGGGGBBBB((((ffffllllooooaaaatttt ****hhhhbbbbuuuuffff,,,, ffffllllooooaaaatttt ****ssssbbbbuuuuffff,,,, ffffllllooooaaaatttt ****vvvvbbbbuuuuffff,,,,
  112.                       sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,,
  113.                       iiiinnnntttt nnnn))));;;;
  114.  
  115.      HLS Conversions:
  116.  
  117.      vvvvooooiiiidddd iiiimmmmppppRRRRGGGGBBBBttttooooHHHHLLLLSSSS((((sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,,
  118.                       ffffllllooooaaaatttt ****hhhhbbbbuuuuffff,,,, ffffllllooooaaaatttt ****llllbbbbuuuuffff,,,, ffffllllooooaaaatttt ****ssssbbbbuuuuffff,,,,
  119.                       sssshhhhoooorrrrtttt uuuunnnniiiittttyyyy,,,, iiiinnnntttt nnnn))));;;;
  120.  
  121.      vvvvooooiiiidddd iiiimmmmppppHHHHLLLLSSSSttttooooRRRRGGGGBBBB((((ffffllllooooaaaatttt ****hhhhbbbbuuuuffff,,,, ffffllllooooaaaatttt ****llllbbbbuuuuffff,,,, ffffllllooooaaaatttt ****ssssbbbbuuuuffff,,,,
  122.                       sssshhhhoooorrrrtttt ****rrrrbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****ggggbbbbuuuuffff,,,, sssshhhhoooorrrrtttt ****bbbbbbbbuuuuffff,,,,
  123.                       sssshhhhoooorrrrtttt uuuunnnniiiittttyyyy,,,, iiiinnnntttt nnnn))));;;;
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. iiiimmmmppppRRRRGGGGBBBBttttooooWWWW((((3333))))                     IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                      iiiimmmmppppRRRRGGGGBBBBttttooooWWWW((((3333))))
  137.  
  138.  
  139.  
  140. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  141.      The functions described here perform color space conversion between a
  142.      given color space and RGB. The actual transformations performed are
  143.      described below. Certain functions specify the parameter _u_n_i_t_y. _u_n_i_t_y
  144.      should be set to the value of maximum possible intensity for the arrays
  145.      specified. For example, if eight bit data is being converted, _u_n_i_t_y would
  146.      be specified as 255. If the data makes use of the full sixteen bits
  147.      available in each array element, _u_n_i_t_y would be specified as 65535. Note
  148.      that the parameter _n specifies the number of elements in the arrays and
  149.      not the number of bytes.
  150.  
  151.      W Conversions:
  152.  
  153.                                           R
  154.      W   =  | 0.299   0.587   0.114 | *   G
  155.                                           B
  156.                                         |||
  157.  
  158.                                             |||
  159.  
  160.  
  161.  
  162.       R         W
  163.       G    =    W
  164.       B         W
  165.      |||
  166.  
  167.          |||
  168.  
  169.               |||
  170.  
  171.                   |||
  172.  
  173.  
  174.  
  175.      K Conversions:
  176.  
  177.                                           1.0 - R
  178.      K   =  | 0.299   0.587   0.114 | *   1.0 - G
  179.                                           1.0 - B
  180.                                         |||
  181.  
  182.                                                   |||
  183.  
  184.  
  185.  
  186.       R         1.0 - K
  187.       G    =    1.0 - K
  188.       B         1.0 - K
  189.      |||
  190.  
  191.          |||
  192.  
  193.               |||
  194.  
  195.                         |||
  196.  
  197.  
  198.  
  199.      CMY Conversions:
  200.  
  201.       C        1.0 - R
  202.       M   =    1.0 - G
  203.       Y        1.0 - B
  204.      |||
  205.  
  206.         |||
  207.  
  208.              |||
  209.  
  210.                        |||
  211.  
  212.  
  213.  
  214.       R        1.0 - C
  215.       G   =    1.0 - M
  216.       B        1.0 - Y
  217.      |||
  218.  
  219.         |||
  220.  
  221.              |||
  222.  
  223.                        |||
  224.  
  225.  
  226.  
  227.      YIQ Conversions:
  228.  
  229.       Y        0.299    0.587    0.114       R
  230.       I   =    0.596   -0.274   -0.322   *   G
  231.       Q        0.212   -0.523    0.311       B
  232.      |||
  233.  
  234.         |||
  235.  
  236.              |||
  237.  
  238.                                        |||
  239.  
  240.                                            |||
  241.  
  242.                                                |||
  243.  
  244.  
  245.  
  246.       R        1.000    0.955    0.622       Y
  247.       G   =    1.000   -0.271   -0.648   *   I
  248.       B        1.000   -1.107    1.702       Q
  249.      |||
  250.  
  251.         |||
  252.  
  253.              |||
  254.  
  255.                                        |||
  256.  
  257.                                            |||
  258.  
  259.                                                |||
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.                                                                         PPPPaaaaggggeeee 3333
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274. iiiimmmmppppRRRRGGGGBBBBttttooooWWWW((((3333))))                     IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                      iiiimmmmppppRRRRGGGGBBBBttttooooWWWW((((3333))))
  275.  
  276.  
  277.  
  278.     |
  279.         |
  280.              |
  281.                                        |
  282.                                            |
  283.                                                |
  284.  
  285.      YUV Conversions:
  286.  
  287.       Y         0.299    0.587    0.114       R
  288.       U   =    -0.147   -0.289    0.436   *   G
  289.       V         0.615   -0.515   -0.100       B
  290.      |||
  291.  
  292.         |||
  293.  
  294.              |||
  295.  
  296.                                         |||
  297.  
  298.                                             |||
  299.  
  300.                                                 |||
  301.  
  302.  
  303.  
  304.       R        1.000    0.000    1.140       Y
  305.       G   =    1.000   -0.395   -0.581   *   U
  306.       B        1.000    2.032    0.000       V
  307.      |||
  308.  
  309.         |||
  310.  
  311.              |||
  312.  
  313.                                        |||
  314.  
  315.                                            |||
  316.  
  317.                                                |||
  318.  
  319.  
  320.  
  321.      YCbCr Conversions:
  322.  
  323.       Y          0.299    0.587    0.114       R
  324.       Cb   =    -0.169   -0.331    0.500   *   G
  325.       Cr         0.500   -0.419   -0.081       B
  326.      |||
  327.  
  328.          |||
  329.  
  330.               |||
  331.  
  332.                                          |||
  333.  
  334.                                              |||
  335.  
  336.                                                  |||
  337.  
  338.  
  339.  
  340.       R        1.000   -0.001    1.402       Y
  341.       G   =    1.000   -0.344   -0.714   *   Cb
  342.       B        1.000    1.772    0.001       Cr
  343.      |||
  344.  
  345.         |||
  346.  
  347.              |||
  348.  
  349.                                        |||
  350.  
  351.                                            |||
  352.  
  353.                                                 |||
  354.  
  355.  
  356.  
  357.      CMYK Conversions:
  358.  
  359.      Ci   =    1.0 - R
  360.      Mi   =    1.0 - G
  361.      Yi   =    1.0 - B
  362.      K    =    Min(Ci, Mi, Yi)
  363.      C    =    Ci - K
  364.      M    =    Mi - K
  365.      Y    =    Yi - K
  366.  
  367.      Ci         =    1.0 - R
  368.      Mi         =    1.0 - G
  369.      Yi         =    1.0 - B
  370.      Ki         =    Min(Ci, Mi, Yi)
  371.      Kucr       =    UCR(Ki)
  372.      Device C   =    Min(1.0, Max(0.0, Ci - Kucr))
  373.      Device M   =    Min(1.0, Max(0.0, Mi - Kucr))
  374.      Device Y   =    Min(1.0, Max(0.0, Yi - Kucr))
  375.      Device K   =    BG(Ki)
  376.  
  377.      Ci   =    C + K
  378.      Mi   =    M + K
  379.      Yi   =    Y + K
  380.      R    =    1.0 - Min(1.0, Ci)
  381.      G    =    1.0 - Min(1.0, Mi)
  382.      B    =    1.0 - Min(1.0, Yi)
  383.  
  384.      For HSV conversions refer to _C_o_m_p_u_t_e_r _G_r_a_p_h_i_c_s, _P_r_i_n_c_i_p_a_l_s _a_n_d _P_r_a_c_t_i_c_e,
  385.      _F_o_l_e_y _a_n_d _V_a_n _D_a_m, _2_n_d. _E_d_i_t_i_o_n, pp. 590-592.
  386.  
  387.  
  388.  
  389.  
  390.                                                                         PPPPaaaaggggeeee 4444
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397. iiiimmmmppppRRRRGGGGBBBBttttooooWWWW((((3333))))                     IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                      iiiimmmmppppRRRRGGGGBBBBttttooooWWWW((((3333))))
  398.  
  399.  
  400.  
  401.      For HLS conversions refer to the citing above pp. 592-595.
  402.  
  403. NNNNOOOOTTTTEEEE
  404.      It is the caller's responsibility to allocate all buffer storage.
  405.  
  406. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  407.      libimp(3)
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.                                                                         PPPPaaaaggggeeee 5555
  457.  
  458.  
  459.  
  460.